home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / wc3x / stats212.zip / STATS.DOC < prev    next >
Text File  |  1992-12-02  |  8KB  |  215 lines
  1.  
  2.                                The Stats Machine
  3.                                    Ver. 2.12
  4.  
  5.                             A Wildcat! 3.XX Utility
  6.  
  7.                              Written by Tim Pryor
  8.  
  9.                      (C) 1991, 1992  UP Technologies, Inc.
  10.                              All Rights Reserved.
  11.  
  12.                               The Upper Limit BBS
  13.                                 (410) 860-0212
  14.                                  300/1200/2400
  15.                                  24 Hrs. 8/N/1
  16.  
  17.  
  18.  
  19.  
  20.                                   DISCLAIMER
  21.  
  22.     UP Technologies, Inc.  makes no warranty of any  kind, either expressed
  23.     or  implied,  including  but  not  limited  to  implied  warranties  of
  24.     merchantability and  fitness for a particular  purpose, with respect to
  25.     this software and accompanying documentation.
  26.  
  27.     IN  NO EVENT  SHALL UP  TECHNOLOGIES, INC.  BE LIABLE  FOR ANY  DAMAGES
  28.     (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION,
  29.     LOSS OF BUSINESS  INFORMATION, OR OTHER PECUNIARY LOSS)  ARISING OUT OF
  30.     THE  USE  OF  OR  THE  INABILITY  TO  USE  THIS  PROGRAM,  EVEN  IF  UP
  31.     TECHNOLOGIES, INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  32.  
  33.  
  34.                                    Trademarks
  35.              Wildcat! BBS is a trademark of Mustang Software, Inc.
  36.  
  37.  
  38.     I. Introduction
  39.  
  40.     The Stats Machine is a useful sysop utility for Wildcat 3.xx which
  41.     generates two bulletins (one color and one mono) of statistics by
  42.     reading the ACTIVITY.XXX file.
  43.  
  44.     NOTE: This version of The Stats Machine only reads the ACTIVITY.001
  45.     file. Future versions might be written for use with multi-node systems.
  46.  
  47.     Currently the program will keep track of the following statistics:
  48.  
  49.          - # and % of calls for each baud rate (300,1200,2400,9600,14400,
  50.            and LOCAL)
  51.  
  52.          - # and % of calls per day of the week
  53.  
  54.          - # and % of calls per hour of the day
  55.  
  56.          - # and % of most type of logoffs (including normal, drop carrier,
  57.            exceeded time limit, no activity)
  58.  
  59.          - # and % of file transfers for each protocol
  60.  
  61.          - The top five most popular questionnaires (with corresponding #
  62.            and %) NOTE: This version only keeps track of the first 10
  63.            questionnaires. Future versions might include more.
  64.  
  65.          - # of downloads
  66.  
  67.          - # of uploads
  68.  
  69.          - # of new users added since last run of The Stats Machine
  70.  
  71.          - # of questionnaires answered
  72.  
  73.          - # of doors opened
  74.  
  75.          - # of times Sysop was paged
  76.  
  77.          - # of times newsletter was read
  78.  
  79.          - Total number of messages left
  80.  
  81.          - # and % of ANSI and non-ANSI calls
  82.  
  83.          - # and % of MNP and non-MNP calls
  84.  
  85.          - # and % of illegal logon attempts
  86.  
  87.          - # and % of cancelled file transfers
  88.  
  89.          - first date in ACTIVITY.001 file
  90.  
  91.          - current date
  92.  
  93.          - misc. graphs
  94.  
  95.          - and a few other stats
  96.  
  97.  
  98.     NOTE: You may encounter an occasional problem with some of the numbers 
  99.     not adding up correctly (for example, total logons not equalling total 
  100.     logoffs, or total file transfers [by protocol] not equalling total 
  101.     uploads and downloads). The problem arises with the format of the 
  102.     ACTIVITY.001 file used by Wildcat.  
  103.  
  104.  
  105.     The following files should be included in the zip file:
  106.  
  107.       STATS.EXE    - The executable portion of The Stats Machine.
  108.       STATS.DOC    - The file you are reading right now.
  109.       ORDERFRM.DOC - Registration form.
  110.       SAMPLE.TXT   - Sample bulletin (mono) created with The Stats Machine
  111.       SAMPLEQ.TXT  - Sample 'QUICK' bulletin (mono) that can be created with
  112.                      the registered version of The Stats Machine.
  113.       PROGS.TXT    - Listing of other Wildcat programs written by UP 
  114.                      Technologies, Inc. 
  115.       README.NOW   - File contains additional information.
  116.  
  117.  
  118.     If any of these files are missing, you can always download the latest
  119.     version of The Stats Machine from The Upper Limit BBS at (410) 860-0212.
  120.  
  121.  
  122.     II. Running The Stats Machine
  123.  
  124.     To run the program, type the following at the DOS prompt:
  125.  
  126.     STATS [/g] [/s] [/?]
  127.  
  128.     Running the program will result in the creation of two new  files:
  129.     STATS.BBS (color version) and STATS.TXT (mono version). The color file
  130.     uses the Wildcat color codes.
  131.  
  132.     Optional Parameters
  133.  
  134.     The /G parameter will result in the creation of several
  135.     graphs including: Calls by Days of the Week, Calls by Baud Rate, File
  136.     Transfers by Protocol Used, Top 10 Doors, Top 10 Bulletins, Top 10
  137.     Questionnaires, ANSI vs. Non-ANSI Calls, MNP .vs Non-MNP Calls, and
  138.     Calls by Hours of the Day. These graphs will be included in the
  139.     bulletins. The graphs also use Wildcat color codes.
  140.  
  141.     The /S parameter will allow you to save stat totals to a file called 
  142.     "STATS.DAT." It is now possible to read these stats in from the STATS.DAT
  143.     file, in addition to reading the ACTIVITY.001 file. In order to prevent
  144.     totals from being added twice, the ACTIVITY.001 file will be deleted upon
  145.     completion of running the Stats Machine if this parameter is selected. If
  146.     you want to maintain a collection of your activity files, just add a line
  147.     in your batch file to copy ACTIVITY.001 to another file. 
  148.  
  149.  
  150.     The /? parameter will display a help screen with a list of optional
  151.     parameters.
  152.  
  153.     NOTE: If any parameters other than the ones mentioned above are used,
  154.     the program will ignore them.
  155.     
  156.  
  157.     IV. Registration
  158.  
  159.     The Stats Machine is not free or in the public domain. It is
  160.     shareware, which means that you are expected to pay for it if you find
  161.     it useful. Registration is only $10 US. If you use The Stats Machine
  162.     for more than one month, you should register it. When you register The
  163.     Stats Machine your board name will appear in the opening screen. For
  164.     more information, refer to the ORDERFRM.DOC file.
  165.  
  166.     When you register the Stats Machine, you get extra features, including:
  167.  
  168.  
  169.     * Your BBS name in bulletin screens.
  170.     
  171.     * Ability to create a 'QUICK' one-screen file with the most important 
  172.       stats.
  173.     
  174.     * Ability to create mono file. By default, the registered version does NOT
  175.       create a mono file automatically.
  176.     
  177.     * Extra screen containing information on BBS events.
  178.  
  179.     
  180.     By registering The Stats Machine, this will provide me with encouragement
  181.     to add further enhancements and features.
  182.  
  183.  
  184.     V. Acknowledgments
  185.  
  186.     I would like to thank the following Sysops for their assistance:
  187.  
  188.               
  189.                                 Steve McCoy
  190.                                MCE Databoard
  191.                                Salisbury, MD
  192.                               (410) 543-2406
  193.  
  194.    
  195.                               Phil Pattengale 
  196.                            The Graphics Shop BBS
  197.                                Kalamazoo, MI
  198.                               (616) 375-2083
  199.  
  200.  
  201.  
  202.     VI. Questions and Comments
  203.  
  204.     If you have any questions or comments concerning The Stats Machine,
  205.     you can contact me on my bbs:
  206.  
  207.  
  208.                               The Upper Limit BBS
  209.                                 (410) 860-0212
  210.                                  300/1200/2400
  211.                                  24 Hrs. 8/N/1
  212.  
  213.                         Full Access on Your First Call!
  214.  
  215.